home *** CD-ROM | disk | FTP | other *** search
/ Gamers Delight 2 / Gamers Delight 2.iso / Aminet / game / role / NetHk312.lzh / ReadMe < prev    next >
Text File  |  1993-02-03  |  9KB  |  209 lines
  1.  
  2.         Using and Installing Amiga NetHack 3.1
  3.       (or Everything You Never Wanted to Know Before NetHacking)
  4.  
  5.          Last Revision: 28 January 1993 for NetHack 3.1
  6.  
  7.  
  8. I. Introduction
  9.  
  10. I.A. Overview
  11.     Welcome to Amiga NetHack!  If this is your first visit to our fair
  12.     city, you are in for an amazing and dangerous journey; if you have
  13.     visited us before, beware! the city has changed in many strange and
  14.     subtle ways; it has also grown quite a bit.  This missive brings to
  15.     light those mundane tasks which must be dealt with before beginning
  16.     your journey; for those of you who are faced with the task of
  17.     installing the pre-fabricated version of our town, section III
  18.     (Installing Amiga NetHack 3.1) will guide you through the task at
  19.     hand.  If you are ready to visit, the local visitors guide is in
  20.     section II (Using Amiga NetHack 3.1); please also see the general
  21.     guide packaged separately (the file GuideBook).
  22.  
  23.     To all our visitors, a hearty Welcome! - and please be careful.
  24.  
  25.     [Those responsible for the previous paragraphs have been sacked.  The
  26.     documentation has been completed at great expense in a more traditional
  27.     style. -- The Management]
  28.  
  29. I.B. Getting Help
  30.     If you have questions about strategy, weapons, or monsters, the best
  31.     place to go for help is the Usenet newsgroup rec.games.hack.  If you
  32.     have problems with installation or think you have found a bug in
  33.     the game, please report it by electronic mail to the development
  34.     group at nethack-bugs@linc.cis.upenn.edu, where it will be routed
  35.     to the appropriate person.  Include your configuration, the version of
  36.     NetHack you are playing, and as much specific information as possible.
  37.     As NetHack runs on many different machines, be sure to mention that
  38.     you are playing the Amiga version.  Finally, if you are having trouble
  39.     compiling NetHack, you may use the same address, or, for compiler
  40.     specific problems, send mail to:
  41.         Greg Olson (golson@sundown.sun.com)  for Manx
  42.         Ken Lorber (keni@oasys.dt.navy.mil) for SAS/C, or
  43.         Richard Addison (addison@pollux.usc.edu) for either.
  44.     We do not currently have a contact for the DICE port.
  45.  
  46. I.C. Credits
  47.     Olaf Seibert first ported NetHack 2.3 and 3.0 to the Amiga.  Richard
  48.     Addison, Jochen Erwied, Mark Gooderum, Ken Lorber, Greg Olson, Mike
  49.     Passaretti, and Gregg Wonderly polished and extended the 3.0 and 3.1
  50.     ports.
  51.  
  52.  
  53. II. Using Amiga NetHack 3.1
  54.  
  55. II.A. Sources of Information
  56.     Where to go depends on what you want to find out.  If you want to find
  57.     out about distributing NetHack, read the license (in NetHack:license or
  58.     type ?i during the game).  For an introduction to NetHack, read the
  59.     GuideBook file.  Finally, for information during the game on all kinds
  60.     of things, type ? and select from the menu.
  61.  
  62. II.B. The Amiga NetHack WorkBench Front End
  63.     The Amiga NetHack Front End looks more or less like a WorkBench
  64.     Drawer - and acts the same way.  Games start with double clicks and
  65.     menus provide more detailed control of games and defaults.  On-line
  66.     help is available - just press the help key.
  67.  
  68.     Just as with WorkBench itself, options for games are set using the Info
  69.     menu item to modify Tooltypes.  Most common options can be set more 
  70.     easily using buttons available via Info also.
  71.  
  72.     You can adjust the following using the ToolTypes from the Info command:
  73.  
  74.     * OPTIONS=<options> - Options as available in the NetHack.cnf file.
  75.  
  76.     * HACKDIR=<directory> - Set NetHack working directory to be this
  77.       directory.
  78.  
  79.     * LEVELS=<levels> - Intermediate level saving device/directory.
  80.  
  81.     * PATH=<path> - To search for files such as rumors, help, etc.
  82.  
  83.     * CMDLINE=<args> - Arguments as passed on the CLI command line.
  84.       Note:  only the following flags are valid: n, X, D, and r.
  85.  
  86.     * SCORE <options> - Display the record of scores.  Options as
  87.       available on the CLI command line after a -s flag.
  88.  
  89.     Note that the NetHack.cnf file is read first, then the ToolTypes.  This
  90.     means that the options specified in the NetHack.cnf act as defaults
  91.     which can be overridden by an individual's personal icon's ToolTypes.
  92.     Thus the system oriented entries (HACKDIR, LEVELS, and PATH) should
  93.     generally be set only in NetHack.cnf.  NetHack.cnf should have default
  94.     values for OPTIONS, which will generally be overridden by ToolTypes
  95.     entries.
  96.  
  97.     Also, there is one additional option that may be specified in the
  98.     NetHack.cnf file or on an OPTIONS line: flush.  When enabled, flush
  99.     discards all characters in the queue except the first, which limits
  100.     typeahead accidents.  The default setting is noflush.
  101.  
  102.     Usually, most of the confusing options will be set in the NetHack.cnf
  103.     file once when the game is installed and can be ignored after that.
  104.  
  105. II.C. The Amiga NetHack CLI Front End
  106.     The CLI Front End provides the standard Unix-like command line interface
  107.     to NetHack.  Unlike the Unix front end however, the CLI front end will
  108.     ask if you want to play again before exiting.  See the ManPage file for
  109.     the standard Unix flags for NetHack.  In addition to those flags, Amiga
  110.     NetHack accepts flags -l to force non-interlaced mode and -L to force
  111.     interlaced mode.
  112.  
  113.  
  114. III. Installing Amiga NetHack 3.1
  115.  
  116. III.A. General Installation
  117.     Installation should be easy - basically it consists of putting files
  118.     where they belong and adding assigns to your startup.  If you are
  119.     installing from the official binary distribution, simply unpacking
  120.     each archive in the appropriate directory will put the files in the
  121.     places they belong (note that the archives may have been split
  122.     for distribution).  If you are installing from source, most of this
  123.     work will be done by the time the build is finished.
  124.  
  125.     IF YOU ALREADY HAVE A PREVIOUS VERSION INSTALLED YOU MUST DELETE THE
  126.     OLD SAVE AND BONES FILES - THEY WILL NOT WORK!
  127.  
  128. Will NetHack fit on your machine?
  129.     NetHack 3.1 is large.  NetHack 3.1 is very large.  You will need:
  130.     > Amiga 500, 1000, 2000, 2500, or 3000.  The A600, A1200, and A4000
  131.       should work, but have not been tested.
  132.     > WorkBench 1.3 or 2.04.  WorkBench 1.2 will NOT work; we will NOT
  133.       be fixing that.  WorkBench 2.1 and 3.0 should work but have not been
  134.       tested.
  135.     > At least 2 meg of RAM.  NetHack will NOT run in 1 meg.
  136.     > Mass storage: NetHack will run on one floppy - but it won't be nice.
  137.       Two floppies are almost enough.  A hard drive with over 3 meg of
  138.       free space is recommended.
  139.  
  140. Find space for the files
  141.     Floppy installation:
  142.     Format four disks named:
  143.         NetHack
  144.         HackExe
  145.         NHsave
  146.         NHlevels
  147.     Hard Disk installation:
  148.         cd to wherever you want to install NetHack
  149.     make the main NetHack directory:
  150.       makedir NetHack
  151.     and the subdirectories:
  152.       makedir NetHack/save
  153.       makedir NetHack/levels
  154.     In s:User-Sequence (under 2.0 or later) or s:Startup (under 1.3),
  155.     assign NetHack: to the NetHack directory you created above.
  156.     assign HackExe: to the same directory.
  157. Install the files
  158.     Unpack the archives in the directories or onto the disks (you can
  159.     tell what to unpack where by the file names) by cd'ing to HackExe:
  160.     and unpacking archive 1 and then to NetHack: and unpacking archive 2.
  161.     Use the table in the next section to see where things should end up.
  162.     Be sure that the file 8 ends up in NetHack:hack/8.
  163.  
  164. Configuration
  165.     Using your favorite text editor, edit NetHack:NetHack.cnf to match
  166.     your system.  Check HackExe:NetHack.dir and be sure that the paths
  167.     are correct.  The HackWB program uses several standard Amiga programs
  168.     that must be installed in their standard places: c:copy, c:rename.
  169.  
  170. III.B. File Location Table
  171.     NetHack:
  172.     A-filla.lev    A-fillb.lev    A-goal.lev    A-locate.lev
  173.     A-start.lev    air.lev        amii.hlp    asmodeus.lev
  174.     astral.lev    B-filla.lev    B-fillb.lev    B-goal.lev
  175.     B-locate.lev    B-start.lev    baalz.lev    bigroom.lev
  176.     C-filla.lev    C-fillb.lev    C-goal.lev    C-locate.lev
  177.     C-start.lev    castle.lev    cmdhelp        data
  178.     default.icon    dungeon        E-filla.lev    E-fillb.lev
  179.     E-goal.lev    E-locate.lev    E-start.lev    earth.lev
  180.     fakewiz1.lev    fakewiz2.lev    fire.lev    Guidebook
  181.     Guidebook.info    H-filla.lev    H-fillb.lev    H-goal.lev
  182.     H-locate.lev    H-start.lev    hack/8        hack.font
  183.     HackWB        HackWB.info    HackCli        help
  184.     hh        history        juiblex.lev    K-filla.lev
  185.     K-fillb.lev    K-goal.lev    K-locate.lev    K-start.lev
  186.     knox.lev    license        logfile        ManPage
  187.     ManPage.info    medusa-1.lev    medusa-2.lev    minefill.lev
  188.     minetown.lev    mine_end.lev    NetHack.cnf    NetHack.c01
  189.     NetHack.d00    news        NewGame.info    opthelp
  190.     options        oracle.lev    oracles        orcus.lev
  191.     P-filla.lev    P-fillb.lev    P-goal.lev    P-locate.lev
  192.     P-start.lev    perm        quest.dat    R-filla.lev
  193.     R-fillb.lev    R-goal.lev    R-locate.lev    R-start.lev
  194.     ReadMe        ReadMe.info    record        recover
  195.     RecoverMan    RecoverMan.info    rumors        S-filla.lev
  196.     S-fillb.lev    S-goal.lev    S-locate.lev    S-start.lev
  197.     sanctum.lev    T-filla.lev    T-fillb.lev    T-goal.lev
  198.     T-locate.lev    T-start.lev    tower1.lev    tower2.lev
  199.     tower3.lev    V-filla.lev    V-fillb.lev    V-goal.lev
  200.     V-locate.lev    V-start.lev    valley.lev    W-filla.lev
  201.     W-fillb.lev    W-goal.lev    W-locate.lev    W-start.lev
  202.     water.lev    wizard1.lev    wizard2.lev    wizard3.lev
  203.     wizhelp
  204.  
  205.     HackExe:
  206.     NetHack.dir
  207.     NetHack.c00
  208.  
  209.